package com.dts.yjnb.service.mapper;

import com.dts.yjnb.service.domain.Agricultural;
import com.github.pagehelper.Page;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 农事服务Mapper接口
 *
 * @author dts
 */
@Mapper
public interface AgriculturalMapper
{
    /**
     * 农事服务分页查询
     *
     * @param agricultural 查询条件
     * @return 农事服务分页列表
     */
    Page<Agricultural> pageQuery(Agricultural agricultural);

    /**
     * 根据ID查询农事服务详情
     *
     * @param id 农事服务ID
     * @return 农事服务详情
     */
    Agricultural getByid(Long id);

    /**
     * 批量删除农事服务
     *
     * @param ids 农事服务ID列表
     * @return 删除的记录数
     */
    Integer deleteByids(List<Long> ids);

    /**
     * 批量修改农事服务状态
     *
     * @param ids 农事服务ID列表
     * @param status 状态：1已发布 0待发布 2已下架
     * @return 影响的记录数
     */
    Integer updateStatusByids(@Param("ids") List<Long> ids,
                             @Param("status") Integer status);

    /**
     * 批量修改农事服务推荐状态
     *
     * @param ids 农事服务ID列表
     * @param isRecommend 推荐状态：1推荐 0不推荐
     * @return 影响的记录数
     */
    Integer updateRecommendByids(@Param("ids") List<Long> ids,
                                @Param("isRecommend") Integer isRecommend);

    /**
     * 新增农事服务
     *
     * @param agricultural 农事服务信息
     * @return 影响的记录数
     */
    Integer add(Agricultural agricultural);

    /**
     * 修改农事服务
     *
     * @param agricultural 农事服务信息
     * @return 影响的记录数
     */
    Integer update(Agricultural agricultural);

    /**
     * 根据条件模糊查询农事服务
     *
     * @param agricultural 查询条件（包含标题和摘要的模糊查询）
     * @return 农事服务列表
     */
    List<Agricultural> search(Agricultural agricultural);

    /**
     * 统计指定年月的农事服务新增数量
     *
     * @param year 年份
     * @param month 月份（1-12）
     * @return 该月的农事服务数量
     */
    Integer countAgriculturalByYearMonth(@Param("year") int year, @Param("month") int month);

    /**
     * 查询所有农事服务数据（用于导出）
     *
     * @return 农事服务列表
     */
    List<Agricultural> selectAll();

    /**
     * APP端网约农服列表查询（app端农贸服务）
     *
     * @param agricultural 查询条件
     * @return 网约农服列表
     */
    List<Agricultural> getAppOnlineServiceList(Agricultural agricultural);

    /**
     * APP端网约农服详情查询（app端农贸服务）
     *
     * @param id 网约农服ID
     * @return 网约农服详情
     */
    Agricultural getAppOnlineServiceDetail(Long id);

    /**
     * APP端网约农服推荐列表查询（app端农贸服务）
     *
     * @param agricultural 查询条件
     * @return 推荐的网约农服列表
     */
    List<Agricultural> getAppRecommendOnlineServiceList(Agricultural agricultural);

    /**
     * APP端网约农服分类列表查询（app端农贸服务）
     *
     * @param agricultural 查询条件（包含分类ID）
     * @return 指定分类的网约农服列表
     */
    List<Agricultural> getAppOnlineServiceByCategoryList(Agricultural agricultural);

    /**
     * 增加浏览数量（app端农贸服务）
     *
     * @param id 网约农服ID
     * @return 影响的记录数
     */
    Integer increaseBrowseNum(Long id);

    /**
     * 查询最近12个月的数据（按月份分组统计）
     *
     * @param startYear 开始年份
     * @param startMonth 开始月份（1-12）
     * @param lastMonthYear 结束年份
     * @param lastMonth 结束月份（1-12）
     * @return 12个月的数据列表，按1-12月顺序返回
     */
    List<Integer> get12MonthData(@Param("startYear") int startYear,
                                 @Param("startMonth") int startMonth,
                                 @Param("lastMonthYear") int lastMonthYear,
                                 @Param("lastMonth") int lastMonth);
}
